<!DOCTYPE html>
<html prefix="og: http://ogp.me/ns#">
<head>
  <meta charset="UTF-8">
  <title>Getting Started</title>
  <link data-turbolinks-track="true" href="../../assets/application-b86a2086c99917c6bf2a9d74b4038381.css" media="all" rel="stylesheet" />
  <script data-turbolinks-track="true" src="../../assets/application-c3106c6fe52ccec6f26495730a478cca.js"></script>
  <meta content="authenticity_token" name="csrf-param" />
<meta content="yzXUiWH6GiCHbvbJOg7usjzA7LawyxwB+oJHEcWTOIM=" name="csrf-token" />
  <script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

  ga('create', 'UA-3769691-35', 'atom.io');
  ga('send', 'pageview');

</script>

  <meta property="og:url" content="https://atom.io/" />
<meta property="og:site_name" content="Atom" />
<meta property="og:title" content="A hackable text editor for the 21st Century" />
<meta property="og:description" content="At GitHub, we’re building the text editor we’ve always wanted: hackable to the core, but approachable on the first day without ever touching a config file. We can’t wait to see what you build with it." />
<meta property="og:type" content="website" />
<meta property="og:author" content='https://www.facebook.com/GitHub' />
<meta property="og:image" content="http://og.github.com/atom-logo/atom-logo@1200x1200.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="1200" />
<meta property="og:image" content="http://og.github.com/atom-mark/atom-mark@1200x630.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />

  <meta property="twitter:card" content="summary_large_image" />
<meta property="twitter:site" content="@AtomEditor" />
<meta property="twitter:creator" content='@github' />
<meta property="twitter:title" content="Atom" />
<meta property="twitter:description" content="A hackable text editor for the 21st Century" />
<meta property="twitter:image:src" content="http://og.github.com/atom-logo/atom-logo@1200x630.png" />
<meta property="twitter:image:width" content="1200" />
<meta property="twitter:image:height" content="630" />

  <link rel="shortcut icon" href="../../favicon.ico"/>
</head>
<body>

  <div class="footer-push">
    
    

    <header class="header">
  <div class="wrapper">
    <h1 title="Atom">
      <a href="../../index.html" class="logo"></a>
    </h1>

    <ul class="navigation">
      <li><a class="" href="../../packages.html">Packages</a></li>
      <li><a class="is-selected" href="../latest/index.html">Documentation</a></li>
      <li><a href="http://blog.atom.io">Blog</a></li>
      <li><a href="../../faq.html">FAQ</a></li>
      <li><a class="" href="https://atom.io/contact">Contact</a></li>
    </ul>
  </div>
</header>


    <div class="wrapper documents content-push">
  <div class="columns">
    <div class="column main-column markdown">
        <h1>
<a name="getting-started" href="getting-started.html#getting-started"></a>Getting Started</h1>

<p>Welcome to Atom! This guide provides a quick introduction so you can be
productive as quickly as possible. There are also guides which cover
<a href="customizing-atom.html">configuring</a>, <a href="creating-a-theme.html">theming</a>, and <a href="creating-a-package.html">extending</a> Atom.</p>

<h2>
<a name="the-command-palette" href="getting-started.html#the-command-palette"></a>The Command Palette</h2>

<p>If there's one key-command you remember in Atom, it should be <code>cmd-shift-P</code>. You
can always press <code>cmd-shift-P</code> to bring up a list of commands (and key bindings)
that are relevant to the currently focused interface element. This is a great
way to explore the system and learn key bindings interactively. For information
about adding or changing a key binding refer to the <a href="customizing-atom.html">customizing key
bindings</a> section.</p>

<p><img src="https://f.cloud.github.com/assets/1424/1091618/ee7c3554-166a-11e3-9955-aaa61bb5509c.png" alt="Command Palette"></p>

<h2>
<a name="the-basics" href="getting-started.html#the-basics"></a>The Basics</h2>

<h3>
<a name="working-with-files" href="getting-started.html#working-with-files"></a>Working With Files</h3>

<p>Atom windows are scoped to a single directory on disk. If you launch Atom from
the command line via the <code>atom</code> command and don't specify a path, Atom opens a
window for the current working directory. The current window's directory will be
visible as the root of the tree view on the left, and also serve as the context
for all file-related operations.</p>

<h4>
<a name="finding-files" href="getting-started.html#finding-files"></a>Finding Files</h4>

<p>The fastest way to find a file is to use the fuzzy finder. Press <code>cmd-t</code> and
begin typing the name of the file you're looking for. If you are looking for a
file that is already open press <code>cmd-b</code> to bring up a searchable list of open
files. If you are using Git you can use <code>cmd-shift-b</code> to search the list of
files modified and untracked in your project's repository.</p>

<p>You can also use the tree view to navigate to a file. To open and focus the
the tree view, press <code>ctrl-0</code>. The tree view can be toggled open and closed with
<code>cmd-\</code>.</p>

<h4>
<a name="adding-moving-deleting-files" href="getting-started.html#adding-moving-deleting-files"></a>Adding, Moving, Deleting Files</h4>

<p>You can add, move, and delete files and folders by right-clicking them in the
tree view and selecting the desired operation from the context menu. You can
also perform these operations from the keyboard by selecting a file or folder
and using <code>a</code> to add, <code>m</code> to move, and <code>delete</code> to delete.</p>

<h3>
<a name="searching" href="getting-started.html#searching"></a>Searching</h3>

<h4>
<a name="find-and-replace" href="getting-started.html#find-and-replace"></a>Find and Replace</h4>

<p>To search within a buffer use <code>cmd-f</code>. To search the entire project use
<code>cmd-shift-f</code>.</p>

<h4>
<a name="navigating-by-symbols" href="getting-started.html#navigating-by-symbols"></a>Navigating By Symbols</h4>

<p>To jump to a symbol such as a method definition, press <code>cmd-r</code>. This opens a
list of all symbols in the current file, which you can fuzzy filter similarly to
<code>cmd-t</code>.</p>

<p>To search for symbols across your project, use <code>cmd-shift-r</code>. First you'll need
to make sure you have <code>tags</code> (or <code>TAGS</code>) file generated for your project.
This can be done by installing <a href="http://ctags.sourceforge.net/">ctags</a> and
running a command such as <code>ctags -R src/</code> from the command line in your
project's root directory. Using <a href="http://brew.sh/">Homebrew</a>? Just run
<code>brew install ctags</code>.</p>

<p>You can customize how tags are generated by creating your own <code>.ctags</code> file
in your home directory (<code>~/.ctags</code>). Here is <a href="https://github.com/atom/symbols-view/blob/master/lib/.ctags">a good example</a> to start
from.</p>

<h3>
<a name="split-panes" href="getting-started.html#split-panes"></a>Split Panes</h3>

<p>You can split any editor pane horizontally or vertically by using <code>cmd-k right</code>
or <code>cmd-k down</code>. Once you have a split pane, you can move focus between them
with <code>cmd-k cmd-right</code> or <code>cmd-k cmd-down</code>. To close a pane, close all its
editors with <code>meta-w</code>, then press <code>meta-w</code> one more time to close the pane. You
can configure panes to auto-close when empty in the Settings view.</p>

<h3>
<a name="folding" href="getting-started.html#folding"></a>Folding</h3>

<p>You can fold blocks of code by clicking the arrows that appear when you hover
your mouse cursor over the gutter. You can also fold and unfold from the
keyboard with <code>alt-cmd-[</code> and <code>alt-cmd-]</code>. To fold everything, use
<code>alt-cmd-shift-{</code> and to unfold everything use <code>alt-cmd-shift-}</code>. You can also
fold at a specific indentation level with <code>cmd-k cmd-N</code> where N is the
indentation depth.</p>

<h3>
<a name="soft-wrap" href="getting-started.html#soft-wrap"></a>Soft-Wrap</h3>

<p>If you want to toggle soft wrap, trigger the command from the command palette.
Press <code>cmd-shift-P</code> to open the palette, then type "wrap" to find the correct
command. By default, lines will wrap based on the size of the editor. If you
prefer to wrap at a specific line length, toggle "Wrap at preferred line length"
in preferences.</p>

<h2>
<a name="configuration" href="getting-started.html#configuration"></a>Configuration</h2>

<p>Press <code>cmd-,</code> to open the Settings view. This is the place to change settings,
install packages, and change the theme.</p>

<p>For more advanced configuration see the <a href="customizing-atom.html">customization guide</a>.</p>
    </div>
    <div class="column sidebar documents-toc">
      <select class="js-doc-version-switcher version-switcher">
  <option value="v0.69.0">v0.69.0</option>
<option value="v0.68.0">v0.68.0</option>
<option value="v0.67.0">v0.67.0</option>
<option value="v0.66.0">v0.66.0</option>
<option value="v0.65.0">v0.65.0</option>
<option value="v0.64.0">v0.64.0</option>
<option value="v0.63.0">v0.63.0</option>
<option value="v0.62.0">v0.62.0</option>
<option selected="selected" value="v0.61.0">v0.61.0</option>
<option value="v0.60.0">v0.60.0</option>
<option value="v0.59.0">v0.59.0</option>
<option value="v0.58.0">v0.58.0</option>
<option value="v0.57.0">v0.57.0</option>
<option value="v0.56.0">v0.56.0</option>
<option value="v0.55.0">v0.55.0</option>
<option value="v0.54.0">v0.54.0</option>
<option value="v0.53.0">v0.53.0</option>
<option value="v0.51.0">v0.51.0</option>
<option value="v0.50.0">v0.50.0</option>
<option value="v0.49.0">v0.49.0</option>
<option value="v0.48.0">v0.48.0</option>
<option value="v0.47.0">v0.47.0</option>
<option value="v0.46.0">v0.46.0</option>
<option value="v0.45.0">v0.45.0</option>
<option value="v0.44.0">v0.44.0</option>
<option value="v0.41.0">v0.41.0</option>
<option value="v0.40.0">v0.40.0</option>
<option value="0.52.0">0.52.0</option>
</select>


      <ul class="navigation">
        <li><a href="" class="is-selected">Documentation</a></li>
        <li><a href="../api/v0.61.0/api/index.html">API</a></li>
      </ul>

      <hr />

      <form accept-charset="UTF-8" action="/docs/v0.61.0/search" method="get"><div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="&#x2713;" /></div>
        <input class="sidebar-search-field" id="q" name="q" placeholder="Search documentation" type="text" value="" />
</form>
      <h2>
<a name="guides" href="getting-started.html#guides"></a>Guides</h2>

<ul>
<li><a href="getting-started.html">Getting Started</a></li>
<li><a href="customizing-atom.html">Customizing Atom</a></li>
<li><a href="creating-a-package.html">Creating a Package</a></li>
<li><a href="creating-a-theme.html">Creating a Theme</a></li>
<li><a href="publishing-a-package.html">Publishing a Package</a></li>
<li><a href="converting-a-text-mate-bundle.html">Converting a TextMate Bundle</a></li>
<li><a href="converting-a-text-mate-theme.html">Converting a TextMate Theme</a></li>
<li><a href="contributing.html">Contributing</a></li>
</ul><h3>
<a name="advanced-topics" href="getting-started.html#advanced-topics"></a>Advanced Topics</h3>

<ul>
<li><a href="advanced/configuration.html">Configuration</a></li>
<li><a href="advanced/keymaps.html">Keymaps</a></li>
<li><a href="advanced/serialization.html">Serialization</a></li>
<li><a href="advanced/view-system.html">View System</a></li>
</ul>
    </div>
  </div>
</div>


    <div class="footer-pad"></div>
  </div>

  <footer>
  <div class="footer">
    <div class="wrapper">
      <ul class="footer-left">
        <li><a href="../../terms.html">Terms of Use</a></li>
          <li><a href="https://atom.io/login">Sign in</a></li>
      </ul>

      <div class="footer-right">
        <a href="https://github.com"><span class="octicon octicon-code"></span> with <span class="octicon octicon-heart"></span> by <span class="octicon octicon-logo-github"></span></a>
      </div>
    </div>
  </div>
</footer>

</body>
</html>
